home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 June
/
EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso
/
earcd
/
comm2
/
xpack275.lha
/
DOCS
/
XPACK.doc
< prev
Wrap
Text File
|
1995-04-25
|
13KB
|
300 lines
$VER: Xpack DOC XfreqQ Management Tools Williamson 2.75
A collection of useful tools for XfreQ management by Robert Williamson.
Xpack - 5D echomail archiver/router/queuer/scheduler *
Xq - FLO convert, scan outs, Xpack front-end
XList - lists queue for a site, a pattern or all sites *
Xkill - remove a filepattern from a sitepattern *
Xfix - re-queues mail files using Addwork
Xrmv - remove a file from a site queue
AddWork - add a file to a site queue, aware of filetypes
SendFile - a simple version of AddWork
Xflo - online flo conversion
Xcut - online .CUT scan and send
Please note that tools marked with a * require the WB2 Arexx DOS
support library rexxdossupport.library.
XPACK
Xpack archives 5D echomail OUT files and queues and schedules the
archives for transmission. It is designed to work with any Shelter mailer.
If RexxDosSupport.library is not available, XPack will require the mailer
to be ACTIVE in order to operate. It will use the ROOFLOG functionhost if
it is available.
There are presently very few tossers which produce 5D OUT files,
Gordon and Roof being the only two I know of myself. In order to provide
an upgrade path to others, I have included the utility XQ.rexx as a
frontend to Xpack.
Installation:
Archivers are expected to be either resident or on the current
path.
ClipList Variables:
The following arexx clipvars are expected to be set:
DOMAIN - the default domain (eg: FIDONET)
HOST.ADDRESS.<domain> - 4d address in each domain
* POINTNET - your pointnet,if you are the BOSS
REXXDIR - path to ROOF/SHELTER rexx scripts
OUTDIR - where 5D OUT files are found,
and arcmail archives are placed
* PKMDIR - temporary work path,
will be created by Xpack
* PKTDIR - outbound for packets
will be created by Xpack
SCREEN - public screen on which to open
Xpack window
FLODIR - where *.?LO files are found,
in a secure system, this should NOT
be OUTDIR.
With Shelter Mailers, you will have to set the clipvars indicated
"*" yourself. Note that PKTDIR should be set to your FLODIR. A simple
AmigaDOS script, in the format: RxSet variablename value, should do the
trick.
Xpack:
The XPACK.CFG is expected to be found in the CFG: volume.
Each address is customized to the targets preferred archiving method,
mail flavour, poll command and poll windows for mail pickup/delivery, freqs
etc. For example 'PollMGR sched 1:167/90.0' might invoked from the POLL
script if un-able to connect during the Cron-invoked window. Refer to the
sample for more information.
Compression types supported are ARC, LHA, LZH, ZIP, NON (none). This
defaults to LHA NORM.
Mail Types Supported: LOCAL, CRASH, HOLD, DIRECT, NORMAL
LOCAL will not be called and should not have any windows.
a command may be specified to move or import with a
point package
HOLD will not be called and should not have any poll
command or poll windows defined.
NORM mail will be SCHEDULED using poll command and poll
windows
CRASH will be called immediately and rescheduled using poll
command and poll windows
A poll window time of '*' indicates immediate redial
(ie dial until connect)
'cmd' should be either the AmigaDOS script POLL or a script specific to a
particular node.
Scheduling requires the ROOF FLOWMGR Function host, so when a Shelter
Mailer is used, the poll window, and cmd options are not available and the
command SHELTER POLL is used instead.
Xpack Usage:
Xpack - will scan defined outbound directory
Xpack outfilename - processes specified ?U(T|0-9) file
Xpack pattern - processes ?U(T|0-9) files matching pattern
FileName Features:
4D OUT - zone.net.node.point.(O|C|D|H|N|L)U(T|(0-9))
4D FLO - zone.net.node.point.(F|C|D|H|N|L)LO
5D OUT - domain.zone.net.node.point.(O|C|D|H|N|L)U(T|(0-9))
5D ARCMAIL - domain.zone.net.node.point.(MO|TU|WE|TH|FR|SA|SU)(0-9)
- Xpack handles LOCAL OUT files
- Xpack is able to handle multiple ?U(T|0-9) files for same address.
- ?UT files are renamed to FTS packets before archiving.
- Transmitted ARCMAIL filename is always based upon our address in
the target domain. Xpack is the only Amiga packer that follows the
ARCmail specification in this regard.
Xpack is based upon PackMgr.rexx by Robert Williamson, which was Based
on Jbundle & Jbun2 by James Mcormond and FidoInOut by Russell McOrmond.
This version is for xferq.library 1.9+ and WPL Mailers v0.97+
XQ
Does the following operations:
- queue files listed in 4D *.?LO files in FLODIR,
.?LO files are then deleted
queued ?UT files are moved to OUTDIR/f,
all others remain in OUTDIR
no filename conversion is done on these
- rename 4D *.?UT files in OUTDIR to 5D
These should NOT be files that are already listed
in processed .FLO files
- call XPACK to route, archive .OUT files and queue
- queue any remaining 5D *.DUT, *.CUT, *.HUT, *.NUT files
any remaining *.OUT files will be ignored unless the internal
flag 'q_outs; is set to 1. Normally, .OUT files are ECHOMAIL
pending archiving, netmail being never put in .OUT files..
Unfortunately, a number of 'modern' tossers/point packages have
chosen to ignore this convention.
XQ:
usage:
Xpack Clean/S,NoCVT/S,No4D/S,Xpack/S,Qouts/S,NoDeleteTIC/S,PktCvt/S,Debug/S
The following lines found at the beginning of the script should be
editied to suit your setup. The first is a list of FTN domain names in
which you are active and the zones they use.
dl="FIDONET 1 FIDONET 2 FIDONET 3 FIDONET 4 FIDONET 5 FIDONET 6 AMIGANET
38 AMIGANET 39 AMIGANET 40 CJNET 100 FRANCOMEDIA 101 MTLNET 17"
Clean do a cleanup of non-existing files
NoCVT FLO to Queue conversion will not be done
Xpack Xpack will be called to process 5D EchoMail OUT files
Qouts Queue OUT files remaining after XPACK
NoDeleteTIC TIC will not be forced to delete after send
No4D 4d to 5d filename conversion not done
PktCvt Packet is converted from 4D FTS1 to 5D FSC39
The last two are mutually exclusive, that is one cannot set No4D
and PktCvt.
eg: Xq xpack Qouts NoDeleteTIC Debug
would eanble xpack, queue outs, no set tic to delete, debug on
Other utils:
ADDWORK
Adds a file to a site queue, allowing the setting of disposition,
priority and queue control. If file is *.?UT then it will be sent
as a *.PKT. If file is ARCmail, an ARCmail sendas name will be
created. Both default to disposition=D (delete) and priority 50
(crash).
ADDWORK site_address fullname disposition priority queuectl
A partial address may be given. It will be expanded based upon the
address variables listed below.
disposition: D=delete if sent
T=truncate if sent to zero bytes
L=do nothing (default)
priority: (-128 to +128) (default 50)
queuectl: I=queue only if connected to site
if set to delete, it IS deleted even if not sent
K=queue only if connected to site,
if set to delete, if it NOT deleted if not sent
A=queue after current session with site
default is none
This utility requires the following clipvars to be set:
DOMAIN - default domain
HOST.ADDRESS.<domain> - address in each domain
If DOMAIN is not set, HOST.address.<domain> will be assumed unset also.
In this case, XFERQ:hostaddr will be use to set these two variables.
SCREEN - public screen name
* POINTNET - PointNet number
This is the net, (eg: 30730) not a point's
FakeNet address (eg: 30730/2)
DOMAINLIST - list of domains and zones
These are all set in both the ROOF System and the Shelter Mailers.
SENDFILE 5Daddress file [sendas] [disposition]
Adds a file to the site queue. If not specified, Disposition is
set to Leave. Valid dispositions are:
D - delete after send
L - leave the file (default)
Priority is always Crash.
Filename sent (SendAs) is the filename without the path unless
otherwise specified..
XRMV 5Daddress file
Remove a file from a site queue.
address must be complete for the network type,
file must be the fullpathname as listed in site queue
XKILL site_pattern file_pattern
This allows one to remove all files matching the file_pattern from
all sites matching the site_pattern. Requires
RexxDosSupport.library
XLIST
Xlist
with no arguments, lists all sites,
and the files, asnames, priorities and dispositions for each.
Xlist #?104.#?
if an amigados pattern is given, only matching sites are listed
Xlist fidonet#1:167/151.0
if a full address is given, nothing will be listed due to
pattern matching, use Xlist fidonet#?1:167/151.0 instead.
format of list is:
sitename
fullname asname priority queuectl dispostion
priority -50 = HOLD
0-30 = NORM
30-50 = DIRECT
50-> = CRASH
120 = INTRANSIT
queuectl I immediate, is queued for current session,
it will be deleted regardless if it is sent or not,
IF it is alos set to delete.
A sendlater, file is queued for the next session
with the online site.
K keep, file is queued for current session (I),
but will not be deleted if it is not sent
IF set to Delete.
dispostion L Leave, files will be untouched after sending
T Truncate, file will be truncated to 0 bytes after
sending
D Delete, file will be deleted after sending
XFIX [DIRECT] 5dHostAddress
Requeues 4D and 5d files using Addwork. If DIRECT option is
specified, all files will be queued for the address indicated by
the filename. Otherwise, all file for one's own points will be
routed to the points primary address defined by 5dHostAddress.
XFLO OutboundDir 5dHostAddress 5dRemoteAddressList
XFLO can called when connected to a site. It is somewhat similar
in operation to an Xferq Freq Handler. It scans for FLO files for
the site and adds listed files to the site queue in IMMEDIATE mode,
according to the priorities derived from the filenames. It also
scans for ?UT files and queues these also. Asnames are created for
both 4D ARcMail and .?UT files.
It is called BEFORE session handshake negotiation as:
SYSTEM "RX XFLO $(OUTBOUND) $(HOST.ADDRESS) $(CALLED)"
$(CALLED) can be either a single address or an AKA list in WPL
address format. The standard WPL address format for FTN is:
"domain#zone:net/node.point".
Since this utility is intended for dial-only points, any files with
a priority of HOLD are changed to NORMAL.
An internal switch allows DISABLING sending of .OUT files.
An even smaller version which only accepts a single remote address,
jaz.f or rap.f, is used with the JAZ and RAP mailers.
XCUT OutboundDir 5dRemoteAddress
Similar to XFLO, this one only scans for a CUT packet for the
address specified. It would be used by a wpl mailer system that
does not have a XferqQ utility to scan for CRASH mail.
It is called BEFORE session handshake negotiation as:
SYSTEM "RX XCUT $(OUTBOUND) $(CALLED)"
$(REMOTE.ADDRESS) camn be used instead of $(CALLED). The standard
WPL address format for FTN is:
"domain#zone:net/node.point"